Shoestring shaders documentation

(this same document is on the website, http://www.des-web.net/html/details.html, with pretty pictures)

 

Ok, here is the documentation- a brief explanation of each slider, checkbox, raido button and doo-hickey.  I know the interfaces are complicated- sorry, a bit of the engineer peeking through. ;-)

 

Grayscale/Desaturate

Gray Scale or Desaturate radio buttons.

You can only select one. Grayscale does a luma-preserving total de-saturation of the Input Shader (which can, of course, be more complex than the Texture map illustrated)

Desaturate activates the sliders in the box, allowing finer control over the color saturations.

Master Saturation Modifier.

Moves saturation of all colors simultaneously. Acts in tandem with the color Saturation Modifers. Positive numbers increase the saturation, negatives decrease it.

Red, Green, or Blue Saturation Modifier.

Moves the saturation of each color independently. Positive numbers increase the saturation, negatives decrease it. Acts in tandem with the Master slider.

 

Iridescent

Center(s)

A zero here indicates that the normal points right at the Vector. The unit is degrees- the range is 0 to 90. This is so you can set up any number of bands (up to 7) spaced however you want.

Falloff(s)

Smaller numbers are wider bands, larger numbers indicate faster falloff, narrower bands.

Color

Color pickers to set the color for each band.

Use 1st Falloff for all checkbox

Hit this checkbox to make the falloff from the 1st box apply to all the others (saves having to copy the value when you want even bands, the most common case)

Fill rest with last color

Anything that falls beyond 90 degrees picks up the last color.

Edge Mix Mode radio buttons (Smooth Mix or Shader Mix)

Controls the way the bands interact. Smooth mix uses a simple sine curve to blend them. Shader mix uses values from the Edge Control shader to add some control to how they are blended. Turbulence and Noise type shaders are good for adding a little randomness.

Edge Control Shader

Shader mix uses values from the Edge Control shader to add some control to how the bands are blended. Turbulence and Noise type shaders are good for adding a little randomness.

Grayscale output and Invert Grayscale checkboxes

Instead of using any of the center, falloff, and color information. a grayscale value is returned. Inverting it allows you to have either black or white be the 0 vector (where the normal points right at the vector). Especially useful for CS3 with the new Gradient shader.

Angle Mode radio buttons, Light Vector or Reference Vector

Light Vector means to point at the object referenced in the text box. Usually a light which would be pointed at the object with the iridescence shader, but it can be any object. Reference Vector lets you define a specific vector. Good for distant lights, just copy the yaw and pitch values in.

Yaw and Pitch

Angles for determining the reference vector. Degrees.

 

Super Mixer

Shader sliders (1-10)

These sliders set the range of luma (returned from the Mix Shader) that map to the Shader picks below. For example, in the above image, if the Mix Shader returns black (zero luma), the Super Mixer will return the value from Shader 1 (red, in this case).

Shader (1-10)

These are the sub-shaders mixed in by Super Mixer. They can have any structure.

Fill undefined checkbox

Setting this checkbox will fill any values NOT covered by a range set with the Shader sliders with Shader 10.

Control Mode radio buttons, Mixer Mode or Add Mode

Mixer mode uses the Mix shader and influences to determine the value returned. Add mode simply adds all the shaders together- useful for combining masks.

Edge Mode radio buttons, Smooth Mix or Shader Mix

Smooth Mix uses a sine-type blending of overlapping shaders. Shader Mix uses input from the Blend shader to control the blending of overlapping shaders.

Edge Blend Use Falloff checkbox

Allows the edges of the shaders to be feathered down.

Edge Blend Percentage Falloff slider

Controls how quickly the edges feather down..

Influence Setup radio buttons, Auto Distribute Influences or Manual Influences

A little time saver. If you click Auto, the shader will find how many of the Shader channels are populated, and set up the influences such that they are evenly distributed. You can’t change them until you switch back to manual.

 

Weave

Tiles U and V sliders

These sliders set how many times to tile the base weave pattern.

U and V Spacing sliders

These set the spacing between the threads. Spacing and thread widths are RELATIVE not absolute.

Width U1-5, V1-5 sliders

These sliders set the widths of the threads. Thread width and spacing are RELATIVE not absolute. (Ie 10, 10, 20 is the same as 1,1,2)

U1-5 and V1-5 shaders

These are the shaders for the threads. They can be simple or complex. You MUST fill from shader 1 to shader 5 without skipping any! Blank shader entries cause the plugin to think it has reached the end of the data. If you want stripes, just leave U1 or V1 blank while populating the other.

Background shader

Values from this shader are used where there are no threads.

Shader Compression, Along and Across checkboxes

Shader compression allows you to sample a shader down such that it will fit within a thread. If you check Across, the shader will be sampled down across the thread. If you check Along, each segment of the thread, where it runs on top of the cross threads, will have the sampled down shader. If you check both, the entire sub-shader will be sampled down into each segment. Note that this shader is UV based- if you try to sample a shader that is not based on UV space, it will not sample down.

Mode radio buttons, Basic Mode or Advanced Mode

Basic Mode is a quick way to do a simple weave. It uses U1 and V1 only. None of the other shaders or widths are used. The On top checkbox matrix is also overridden. (If you haven’t figured it out yet, those are all of the controls below the line. ;-) Adanced mode enables all controls.

On top checkbox matrix

These checkboxes allow you to make any arbitrary pattern of crossovers.

3-D Across and 3-D Along checkboxes

Enable 3-D shading when used in Color channel. Enable bump when used in Bump channel.

Across and Along Intensity sliders

Set how strong the across and along effects are. Smaller numbers are less intense.

Wiggle and Edge Intensity sliders

These sliders control two distortion modes. Wiggle is a large scale distortion wapring. Edge distortion adds effects along the edges of the threads. The base values are taken from the Wiggle and Edge shader channels and then modified by these slider settings.

Wiggle and Edge shaders

These shaders control two distortion modes. Wiggle is a large scale distortion wapring. Edge distortion adds effects along the edges of the threads. The base values are taken from these  shader channels and then modified by the corresponding intensity slider settings.

Mask Only and Invert Mask checkboxes

These checkboxes allow easy mask generation, with all threads black and all spaces white, or vice-versa. It overrides any color choices made in the U, V, and Background shader channels. Very useful for the Transparency channel